home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Leser 15 / Amiga Plus Leser CD 15.iso / Tools / Freeware / PNGTool / PNGTool.doc < prev    next >
Encoding:
Text File  |  2002-03-13  |  3.4 KB  |  109 lines
  1.                       PNGTool
  2.         © 2002 by Stephan Rupprecht
  3.            All rights reserved.
  4.  
  5.  
  6. COPYRIGHT AND DISCLAIMER
  7.  PNGTool is copyrighted 2002 by Stephan Rupprecht. All rights
  8.  reserved. This program is freeware, so no financial donations
  9.  required. Redistribution allowed if the package is left unchanged.
  10.  The author is not responsible for any damage caused by the use
  11.  or misuse of this documentation and/or the program(s) it describes.
  12.  
  13.  PNG support provided by the libpng link library by the PNG Development
  14.  Group, and the zlib link libary by Jean-loup Gailly and Mark Adler.
  15.  
  16.  
  17. REQUIREMENTS
  18.  - Any Amiga® (compatible) computer with at least OS3 and '020+ cpu.
  19.  - picture.datatype v43 or better.
  20.  - asyncio.library v39.
  21.  - A PPC version for computers with WarpUP is also included (requires
  22.    asyncio.library v40).
  23.  
  24.  
  25. DESCRIPTION
  26.  PNGTool is a simple program that can convert any image that is
  27.  recognized by datatypes to PNG.
  28.  
  29.  
  30. INSTALLATION
  31.  Simply copy PNGTool to where-ever-you-want :)
  32.  
  33.  
  34. USAGE
  35.  You can start PNGTool only from shell, since it's a DOS command
  36.  (except for the possibility to start it from Workbench through
  37.  the menu item 'Execute Command...'). The following options are
  38.  provided:
  39.  
  40.  FROM/M/A,TO/A,ALL/S,C=COMPRESSIONLEVEL/N/K,I=INTERLACED/S,S=SCALE/N/K,
  41.  T=TRANSPARENT/N/K
  42.  
  43.  FROM/M/A: specifies the image(s) to convert, patterns will be accepted.
  44.  
  45.  TO/A: name of the new image(s) including the destination path. The specified
  46.   filename is not necessarily just a simple identifier representing exactly 
  47.   one disk object. Instead, it is a template which may contain variables/
  48.   placeholders which will be replaced by their actual values. Placeholders
  49.   recognized are:
  50.   
  51.    %n   name of the source file without suffix. You can shorten the
  52.         filename by providing the maximum number of characters allowed
  53.         between % and n (eg. %5n).
  54.    %nu  Each time an image is converted an internal counter will be
  55.        increased. %nu holds the current value of this counter.
  56.    %w   width of the image.
  57.    %h   its height.
  58.    %d   and the depth
  59.    %sz  shortcut for %wx%hx%d.
  60.  
  61.   NOTE: Source and destination MUST NOT be the same file !
  62.  
  63.  ALL/S: convert subdirectories, too. A new directory in the destination
  64.   drawer _won't_ be created!
  65.  
  66.  C=COMPRESSIONLEVEL/N/K: 0 means no compression, 1 a very little and
  67.   9 best compression at expense of speed (default is 5).
  68.   
  69.  I=INTERLACED/S: create an interlaced image.
  70.  
  71.  S=SCALE/N/K: this option allows you to scale the image down by the
  72.   given denominator. Eg. a value of 2 creates an image that is half
  73.   the size of the original one. This option requires picture.datatype
  74.   v45!
  75.   
  76.  T=TRANSPARENT/N/K: sets the transparent color for the image (if
  77.   palette mapped). A value of -1 disables transparency.
  78.  
  79.  
  80. HISTORY
  81.  1.0  first public release
  82.  1.1  requires asyncio.library v40, now. This increases the speed
  83.       of both versions by 3% :) It also lessens the 68k load when
  84.       using the ppc version even though the ppc load has increased.
  85.       The ppc version now uses a more recent release of libpng
  86.       and zlib making the executable ~30kb smaller. added SCALE/N/K
  87.       option (requires pictdt v45) and TRANSPARENT/N/K. 
  88.  
  89.  
  90. FUTURE
  91.  bugfixes ;)
  92.  your suggestions
  93.  
  94.  
  95. AUTHOR
  96.  Please send bug reports and ideas to
  97.  
  98.      Stephan Rupprecht
  99.      Apfeldweg 1
  100.      D44359 Dortmund
  101.      Germany
  102.  
  103.  Send emails to
  104.  
  105.      info@stephan-rupprecht.de
  106.      
  107.  WWW
  108.          http://stephan-rupprecht.de
  109.